home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / tools / wb-tools / magiceye / magiceye.dok < prev    next >
Text File  |  1996-03-02  |  12KB  |  213 lines
  1.         __       __
  2.         )\\     /((  Version 37.3                            __
  3.        /  \\   /  \\         39.3  __         ________      / \\     ________
  4.       /    \\ /    \\              )\\        )      \\    (   ))    )      \\
  5.      / /\   \V /\   \\            /  \\      / ___    \\    \_//    / ___    \\
  6.     / // \    // \   \\          /    \\    / //  \___//     ___   / //  \___//
  7.    / //   \  //   \   \\        / /\   \\  / // _______      ) \\ / //
  8.   / //     \//     \   \\      / /__\   \\ \ \\ \___  \\    /  // \ \\     ____
  9.  / //               \   \\    / ______   \\ \ \\    )  \\  /  //   \ \\    )  \\
  10. / // © 1995--1996 by \   \\  / //     \   \\ \ \\__/   // /  //     \ \\__/   //
  11. \_)) Christian Krapp  \___)) \_))      \___)) \_______//  \_//       \_______//
  12.          sMail:                     eMail:                 ________ ___ _____
  13.      Christian Krapp                                      / __//\ \V /// __//
  14.      Hagenmähderstr.9   krabbe@informatik.fh-augsburg.de / _//   \  /// _//
  15.    D-86391 Stadtbergen                                  / //__   / /// //__
  16.      (GERMANY)                                          \___//  /_// \___//
  17.                             An AugustA team Release!
  18. --------------------------------------------------------------------------------
  19.  
  20. Copyright:
  21.   Dieses Programm  und alle dazugehörige Dateien (Programm-Icon) sind  Copyright
  22. 1996  bei Christian 'cr8y' Krapp! Es  darf nur  im unveränderten Zustand weiter-
  23. gegeben  werden.  Eine Gebühr, die über den üblichen  Disketten-Preis  zuzüglich
  24. einer geringen Kopiergebühr liegt, darf nicht  erhoben werden.  Desweiteren darf
  25. dieses Programm nicht ohne Genehmigung auf eine PD-Serie oder eine  CD-Rom über-
  26. nommen werden. Diese Genehmigung ist beim Autor erhältlich und wird in der Regel
  27. gegeben.
  28.  
  29.   Nur  für die  AmiNet, FreshFish, und  MeetingPearls  CD-Rom-Serien  sind keine
  30. Genehmigungen nötig.
  31.  
  32.   Dieses Programm  ist weder Public Domain noch Shareware. Es wurde als Freeware
  33. freigegeben.  Jeder der dieses Programm  benutzt sollte mir  eine Postkarte oder
  34. eMail schicken  (Schließlich würde  es mich interessieren, wieviele Leute dieses
  35. Programm benutzen).
  36.  
  37.   Für Schäden, dir durch  die Benutzung  dieses  Programmes  entstehen, kann der
  38. Autor nicht haftbar gemacht werden. 
  39.  
  40. --------------------------------------------------------------------------------
  41.  
  42. Einführung:
  43.   Nein: Dieses Programm ist kein weiteres Programm zum Berechnen von 3D Bildern.
  44. Jeder Amiga-Benutzer  dürfte inzwischen  MagicWB  (und die  zusatz  Icon-Pakete)
  45. kennen.  Auch dürften die  verschiedenen Gag-Programme  bekannt  sein,  die  ein
  46. Augenpaar auf dem Bildschirm anzeigen, das dem Mauszeiger "verfolgt". Doch eines
  47. hat mich schon immer  gestört: Diese Augen passen nicht ganz zum Rest einer auf-
  48. gepeppten Workbench, da die meisten dieser Augenprogramme mit SW-Augen arbeiten.
  49. Aus diesem  Grund  hab ich mir  die "Arbeit" gemacht  und ein farbiges Augenpaar
  50. erstellt.
  51.  
  52. --------------------------------------------------------------------------------
  53.  
  54. 8 Gründe, dieses Programm zu benutzen:
  55.  
  56. 1.) Die Augen sind Bunt ;^)
  57. 2.) Fenster wird geschlossen, wenn WB geschlossen wird (screennotify.library)
  58. 3.) Viele Parameter sind einstellbar
  59. 4.) Patch, damit sich das Augen-Fenster wie die Screentitelleiste verhält
  60. 5.) 6(!) verschiedene Effekte mit den Augen
  61. 6.) Paßt sich an Farbpalette an, MagicWB wird nicht mehr benötigt (AmigaOS 3.0+)
  62. 7.) Sehr kurzes Programm
  63. 8.) Es ist ein Commodity
  64.  
  65. --------------------------------------------------------------------------------
  66.  
  67. Was wird benötigt?
  68.   Auf jeden  Fall braucht  man einen  Amiga-Computer  (oder kompatibel ;^) ) mit
  69. mindestens AmigaOS  2.04 oder höher. Leider  kann ich nicht garantieren, daß die
  70. Programmversion  für AmigaOS 2.04  funktioniert, da  ich nur  einen  Rechner mit
  71. AmigaOS 3.0  besitze. Desweiteren sollte  die Workbench mit mindestens  8 Farben
  72. und einer  möglichst quadratischen-Auflösung  (z.B. 640×512)  betrieben  werden.
  73. Auch  sollte  möglichst  für  die   Bildschirmtitelleiste  ein  Zeichensatz  mit
  74. mindestens der  Größe 13 benutzt werden,  da ansonsten die Augen über die Titel-
  75. leiste  hinausstehen. Um das Fenster  beim schliessen der WB  auch zu schließen,
  76. wird noch die  ScreenNotify-Library von Stefan  Becker benötigt. Ist diese nicht
  77. installiert, wird das Fenster nicht geschlossen.
  78.  
  79. --------------------------------------------------------------------------------
  80.  
  81. Die verschiedenen Programm-Versionen:
  82.   Es ist eigentlich sehr einfach: Da  AmigaOS 3.0  einige bessere Funktionen hat
  83. und es  ermöglicht, die  Farben  auf der Workbench zu reservieren, habe ich mich
  84. entschlossen, zwei Versionen  von  MagicEYE  zu erstellen. Eine  für AmigaOS 2.0
  85. (MagicEYE_37) und eine für AmigaOS 3.0 (MagicEYE_39) und höher.
  86.  
  87. --------------------------------------------------------------------------------
  88.  
  89. Wie wird dieses Programm installiert?
  90.   Es  gibt  fast nichts einfacheres als das:  Man muß nur die richtige Programm-
  91. Version in das WBStartup-Verzeichnis der Startdiskette/-festplatte kopieren. Das
  92. wars dann :-]
  93.   Wer die Programme lieber in der User-Startup startet, kopiert die richtige
  94. Programm-Version am besten in sein C-Verzeichnis und ruft MagicEYE in der
  95. User-Startup mit den entsprechenden Parametern auf.
  96.  
  97. --------------------------------------------------------------------------------
  98.  
  99. Verwendung:
  100.   Dieses Programm kann von der Workbench (bzw. WBStartup-Verzeichnis) oder einer
  101. Shell (User-Startup) aus  gestartet werden. Desweiteren  fehlt dem Programm eine
  102. grafische  Oberfäche. D.h. alle Parameter müssen dem  Programm mittels ToolTypes
  103. im Icon bzw. als Parameter übergeben werden. Folgende Parameter sind möglich:
  104. vorhanden:
  105.  
  106.   DONOTWAIT       : Dies ist  eigentlich kein  Parameter  für MagicEYE,  sondern
  107.                     viel mehr ein  Schalter  für die  Workbench.  Dieser Eintrag
  108.                     sollte nicht entfernt werden!
  109.   WIN_X           : Mit diesen beiden Parametern wird die Position der Augen auf
  110.   WIN_Y             dem Bildschirm  festgelegt. Dabei wird von der oberen linken
  111.                     Ecke aus positioniert! Die voreingestellten Werte sind:
  112.                     WIN_X=545  und WIN_Y=1
  113.                     ACHTUNG: Wenn  ein kleiner  Zeichensatz als Titelleistenfont
  114.                     eingestellt  ist (mindestens  11  Punkte), dann  sollte  man
  115.                     WIN_Y auf 0 setzen!
  116.   PRIORITY        : Gibt die Taskpriorität für das System an. Dieser Wert sollte
  117.                     möglichst  unter 0 liegen, damit  Programm,  die  Rechenzeit
  118.                     benötigen diese auch  erhalten. Im  Programm voreingestellte
  119.                     ist der Wert 0, im Icon ist -5 voreingestellt.
  120.   DRAGPATCH       : Mit diesem (NICHT(!)  systemkonformen) Patch ist es möglich,
  121.                     daß man auch mit dem Augen-Fenster den Bildschirm nach unten
  122.                     bzw. zur Seite verschieben kann. Wird dieses Flag angegeben,
  123.                     so ist der  Patch aktiv,  ansonsten wird  dieser Patch nicht
  124.                     durchgeführt.
  125.   SLEEP_PERIOD    : Dieser Parameter gibt an, wie lange es dauert, bis die Augen
  126.                     geschlossen  werden, wenn  die  Maus nicht mehr bewegt wird.
  127.                     Voreingestellt ist ein Wert von 50. (Einfach mal probieren)
  128.   FRESHUP_PER_SEC : Dieser  Wert gibt an, wie oft  in der  Sekunde die Augen neu
  129.                     gezeichnet, und  damit,  wie oft die Pupillen an  die  Maus-
  130.                     position  angepasst werden  soll. D.h. wenn hier 1 angegeben
  131.                     wird, dann  bedeutet  dies, das  MagicEYE einmal pro Sekunde
  132.                     die Augen an  die  aktuelle  Mausposition  anpasst. Als Vor-
  133.                     einstellung wurde 50  gewählt  (=> 50mal pro Sekunde). Werte
  134.                     größer als 100  sind nicht  sinnvoll  (oder hat jemand einen
  135.                     Workbench-Screen  mit  mehr als 100Hz?) und damit auch nicht
  136.                     möglich. Dieser Wert sollte  möglichst gut überdacht werden,
  137.                     da  er vorallem  auch  die von MagicEYE benötigte Systemzeit
  138.                     angibt  (Je größer  der  Wert,  desto  häufiger  werden  von
  139.                     MagicEYE die Augen neu berechnet und gezeichnet).
  140.  
  141. Und nun zu den 'etwas' interessanteren Effekte-Parametern. Dabei ist anzumerken,
  142. daß die angegebenen Werte die  Wahrscheinlichkeit des  Eintretens dieser Effekte
  143. angibt (1/wert). Es sind nur Werte größer als 1 erlaubt:
  144.  
  145.   SLEEPY          : Mit  diesem Parameter kann  man bestimmen, wie oft die Augen
  146.                     blinzeln  sollen.
  147.   TIRED           : Dieser  Parameter  bestimmt,  wie oft  die  Augenlider  halb
  148.                     herunter klappen.
  149.   ROLL_SYNCHRON   : Bestimmt wie Wahrscheinlichkeit, das  die Pupillen der Augen
  150.                     (synchron, d.h. gleiche Richtung) rollen.
  151.   ROLL_ASYNCHRON  : Bestimmt die Wahrscheinlichkeit, das  die Pupillen der Augen
  152.                     (asynchron, d.h. entgegengesetzte Richtung) rollen.
  153.   LEFTRIGHT       : Wie oft sollen die Augen Links-Rechts schauen?
  154.   RANDOM_EYE      : Gibt an, wie oft die Augen zittern.
  155.   BLOODY          : Bestimmt, wann die Augen rot unterlaufen.
  156.  
  157.   So, daß wäre  eigentlich alles, was man zu diesem Tool wissen müsste. Oder...?
  158. Ach, ich hab noch nicht erzählt, wie man das Programm  beendet? Nun,  eigentlich
  159. meine  ich,  daß dieses Programm auf jede 8 Farben Workbench  gehört. Wenn  aber
  160. jemand dieses Programm  beenden will, dann kann er dies wiefolgt machen (es gibt
  161. zwei Möglichkeiten):
  162. 1.) MagicEYE einfach nochmal starten!
  163. 2.) Exchange starten, MagicEYE aus der Liste auswählen und "Entfernen" anwählen!
  164.  
  165. --------------------------------------------------------------------------------
  166.  
  167. Was kann man an dem Programm noch verbessern?
  168.   * Man kann noch ein paar Spielereien  mit den Augen machen.
  169.   * Man kann noch Augenbrauen einfügen
  170.   * Man kann davon  ausgehen,  das  noch  irgendwelche  Fehler  (undokumentierte
  171.     Möglichkeiten oder gar Käfer ;^) ) enthalten sind, die man entfernen sollte.
  172.  
  173. --------------------------------------------------------------------------------
  174.  
  175. Wer Verbesserungsvorschläge,  Fehler usw. hat, der  kann sollte sich an folgende
  176. Adresse wenden:
  177.  
  178.                  sMail:           Christian Krapp
  179.                                   Hagenmähderstr. 9
  180.                                 D-86391 Stadtbergen
  181.                                   (GERMANY)
  182.                  eMail:           krabbe@informatik.fh-augsburg.de
  183.  
  184. --------------------------------------------------------------------------------
  185.  
  186. Geschichtliches: (xx steht entweder für 37 (AmigaOS 2.04) bzw. 39 (AmigaOS 3.0))
  187.  
  188. Vxx.0   28.04.1995 - Die ersten Arbeiten an dem Programm beginnen (Animationen).
  189. Vxx.1   16.06.1995 - Nach langer Arbeit (und erneutem erstellen der Animationen)
  190.                      ist die erste brauchbare Version fertig.
  191. Vxx.2   01.08.1995 - Ein etwas komischer  Fehler wurde behoben  (Danke an Roland
  192.                      Fulde).
  193.                    - Farbanpassung  implementiert  (Nachdem sich Markus Speicher
  194.                      und Mario  Cattaneo  als  einzige dafür interessiert haben,
  195.                      nur 39.x-Version).
  196.                    - ScreenNotify-Library   wird  unterstützt  (Idee  von  Mario
  197.                      Cattaneo).
  198.                    - Augenrollen (Idee von Dirk Wrocklage).
  199.                    - Zitternde  und rot  unterlaufene  Augen (Idee  von  Michael
  200.                      Krapp).
  201.                    - Augenrollen Asynchron, müde  Augen und Links-Rechts schauen
  202.                      (Idee von Christian Krapp)
  203. Vxx.3   01.03.1996 - ScreenNotify-Library ist nun optional!
  204.                    - Commodity-Library wird vollständig unterstützt!
  205.                    - Jetzt aus Shell oder User-Startup aus startbar.
  206.                    - Rot unterlaufene Augen werden wieder weiß (wenn Augen lang-
  207.                      genug geschlossen).
  208.                    - MagicEYE  hat jetzt  ein besseres  Zeitverhalten. Die alten
  209.                      Versionen liefen nicht korrekt mit Nemac IV (hoher Zeitver-
  210.                      brauch).
  211.  
  212. --------------------------------------------------------------------------------
  213.